home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / misc / joy2key_1_0.lha / Joy2Key.doc < prev   
Text File  |  1992-09-06  |  3KB  |  70 lines
  1.        JOY2KEY v1.0
  2.  
  3. WHAT IS JOY2KEY?
  4.  
  5. Joy2Key  is  a  small  utility  that  converts  joy  movements  into  cursor
  6. movements.   It can be used to move the cursor into a word processor window,
  7. but  it's  main  use is to make some PD games more playable.  How many times
  8. you  loaded you last-arrive wonderful version of Tetrix, but when you pulled
  9. joy  lever the pieces strangely don't moved because game's autor "forgot" to
  10. insert  a joy routine?  Of course you are a good and experienced programmer,
  11. able  to  modify  game's  source  to remedy this little lack...  But what if
  12. source  is  not  supplied (or it is written in ADA or similar)?  No problem,
  13. you  are an expert hacker, so you take your last 68000 asm/dsm/dbg/etc.  and
  14. dismantel  the  executable  code  piece  by  piece,  find  key  routine  and
  15. substitute  it  with  your routine.  But what if you are a mortal man?  It's
  16. simple!  You can load Joy2Key!
  17.  
  18. This  is  version  1.0 - no bugs known (work even with Kick 2.x).
  19.  
  20. HOW MUST I USE JOY2KEY?
  21.  
  22. Load  it from CLI (it must not be RUNned - I used Lattice CBack.o).  Joy2Key
  23. install  an  Input  handler  with  a priority greater than intuition handler
  24. (used  to see if user want quit - LeftALT LeftShift CTRL q).  Then it wait a
  25. joy movement and translate it into appropriate rawkey codes, and insert them
  26. as  new  events  by  RawInsert()  routine.   I  wrote  this  program to play
  27. WellTrix  by  Gary  W.   Milliorn, so program is set up for this (the button
  28. causes the pieces be rotated, so cursordown), but you con easily change this
  29. modifing the first sources lines (some defines), even if you probably need a
  30. program  as  RawInfo  (from  me)  to know rawkey codes to use.  You can also
  31. change  the  sensitivity  of Joy2Key, modifing the TIMEDELAY.  If you define
  32. DEBUG, debug mode will be enabled (Joy2Key will print joy movements).
  33.  
  34. FUTURE IMPROVEMENT
  35.  
  36. Possibility  of  change  default  values from command line, and to load just
  37. after your favorite game.
  38.  
  39. TECNICAL NOTES
  40.  
  41. To compile I used Lattice C 5.10:
  42.  
  43. lc -L -rr <-dDEBUG> joy2key.c
  44.  
  45. (It probably can be compiled only under recent Lattice versions)
  46.  
  47. AUTOR NOTES
  48.  
  49. This  program  is  Public  Domain.  You can copy, distribute, spread if only
  50. with  its  doc  and  sources.   You cannot sell it.  I encourage to read the
  51. source, and use parts of it in your programs if they are PD else it requires
  52. written permission.
  53.  
  54. I  don't  require money if you use it, but it is obiously pleased (or if you
  55. prefer  other  PD  software,  greeting cards or your sister photo (if really
  56. nice), suggestion for improvement...)
  57.  
  58. I'm sorry for lots of error in this doc
  59.  
  60. My home address is:
  61.  
  62.     Via G.Cantore 10
  63.     Conegliano Veneto (TV)
  64.     31015 ITALY
  65.  
  66. My InterNet e-Mail address is:
  67.  
  68. omega@sabrina.dei.unipd.it (at Padova university)
  69.  
  70. *** END OF FILE ***